<?php
/**
 * User Permission Map Interface
 * Interface defines the functions needed to map permissions to groups
 * 
 * 
 * @author Alton Crossley <crossleyframework@nogahidebootstrap.com>
 * @package Crossley Framework
 *  
 * @copyright Copyright (c) 2003-2009, Nogaide BootStrap INC. All rights reserved.
 * @license BSD http://opensource.org/licenses/bsd-license.php
 * @version $Id:$
 * 
 */
interface X_User_Permission_Map_Interface
{
    /**
     * used to lookup permission group/roll
     * with optional detail
     * 
     * @param $sPermissionKey
     * @param $sDetail
     * @return string roll/group key
     */
    public function map($sPermissionKey, $sDetail = Null);
    /**
     * used to set group/roll mapping to a resource permission key
     * with optional detail
     * 
     * @param unknown_type $sRoll
     * @param unknown_type $sPermissionKey
     * @param unknown_type $sDetail
     */
    public function createMap($sRoll, $sPermissionKey, $sDetail = Null);
}